home *** CD-ROM | disk | FTP | other *** search
/ World of Video / World of Video.iso / gfxprograms / conversion / pbmplus / doc / pbmpaste.doc < prev    next >
Text File  |  1995-02-13  |  2KB  |  67 lines

  1.  
  2.  
  3.  
  4. pbmpaste(1)                 PBM Plus                  pbmpaste(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      pbmpaste - paste a rectangle into a portable bitmap
  10.  
  11. SYNOPSIS
  12.      pbmpaste [-replace|-or|-and|-xor] frompbmfile x y
  13.      [intopbmfile]
  14.  
  15. DESCRIPTION
  16.      Reads two portable bitmaps as input.  Inserts the first bit-
  17.      map into the second at the specified location, and produces
  18.      a portable bitmap the same size as the second as output.  If
  19.      the second bitmap is not specified, it is read from stdin.
  20.      The x and y can be negative, in which case they are inter-
  21.      preted relative to the right and bottom of the bitmap,
  22.      respectively.
  23.  
  24.      The flags specify the operation to use when doing the paste.
  25.      The default is replace.  The other operations act as if
  26.      white is 1 and black is 0.
  27.  
  28.      All flags can be abbreviated to their shortest unique pre-
  29.      fix.
  30.  
  31.      This tool is useful in combination with pnmcut(1).  For
  32.      instance, if you want to edit a small segment of a large
  33.      bitmap, and your bitmap editor is TOO STUPID to edit the
  34.      large bitmap, you can cut out the segment you are interested
  35.      in, edit it, and then paste it back in.
  36.  
  37.      Another useful companion tool is pbmmask(1).
  38.  
  39.      The pnmpaste(1) tool is like this one, except that it
  40.      doesn't implement the logical operation flags -- since they
  41.      don't have any useful meaning for grayscale and color
  42.      images.
  43.  
  44. SEE ALSO
  45.      pnmcut(1), pbmmask(1), pnminvert(1), ppmarith(1),
  46.      pnmpaste(1), pbm(5)
  47.  
  48. AUTHOR
  49.      Copyright (C) 1989 by Jef Poskanzer.
  50.  
  51.      Permission to use, copy, modify, and distribute this
  52.      software and its documentation for any purpose and without
  53.      fee is hereby granted, provided that the above copyright
  54.      notice appear in all copies and that both that copyright
  55.      notice and this permission notice appear in supporting docu-
  56.      mentation.  This software is provided "as is" without
  57.      express or implied warranty.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Printed 5/25/90          08 August 1989                         1
  64.  
  65.  
  66.  
  67.